home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat3 / Tk / setclass.z / setclass
Text File  |  1998-10-30  |  3KB  |  67 lines

  1.  
  2.  
  3.  
  4. TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss((((3333TTTTkkkk))))                                              TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss((((3333TTTTkkkk))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      Tk_SetClass, Tk_Class - set or retrieve a window's class
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  13.  
  14.      TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss(_t_k_w_i_n, _c_l_a_s_s)
  15.  
  16.      Tk_Uid
  17.      TTTTkkkk____CCCCllllaaaassssssss(_t_k_w_i_n)
  18.  
  19. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  20.      Tk_Window   _t_k_w_i_n    (in)      Token for window.
  21.  
  22.      char        *_c_l_a_s_s   (in)      New class name for window.
  23.  
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss is called to associate a class with a particular window.  The
  27.      _c_l_a_s_s string identifies the type of the window;  all windows with the
  28.      same general class of behavior (button, menu, etc.) should have the same
  29.      class.  By convention all class names start with a capital letter, and
  30.      there exists a Tcl command with the same name as each class (except all
  31.      in lower-case) which can be used to create and manipulate windows of that
  32.      class.  A window's class string is initialized to NULL when the window is
  33.      created.
  34.  
  35.      For main windows, Tk automatically propagates the name and class to the
  36.      WM_CLASS property used by window managers.  This happens either when a
  37.      main window is actually created (e.g. in TTTTkkkk____MMMMaaaakkkkeeeeWWWWiiiinnnnddddoooowwwwEEEExxxxiiiisssstttt), or when
  38.      TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss is called, whichever occurs later.  If a main window has not
  39.      been assigned a class then Tk will not set the WM_CLASS property for the
  40.      window.
  41.  
  42.      TTTTkkkk____CCCCllllaaaassssssss is a macro that returns the current value of _t_k_w_i_n's class.  The
  43.      value is returned as a Tk_Uid, which may be used just like a string
  44.      pointer but also has the properties of a unique identifier (see the
  45.      manual entry for TTTTkkkk____GGGGeeeettttUUUUiiiidddd for details).  If _t_k_w_i_n has not yet been given
  46.      a class, then TTTTkkkk____CCCCllllaaaassssssss will return NULL.
  47.  
  48.  
  49. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  50.      class, unique identifier, window, window manager
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.